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HOW TO ENTER A CP/M COMMAND 


To give cpe/m® a command, you must type a 
complete command line to the CP/M system 
prompt. A CP/M command line is composed 
of a command keyword, an optional command 
tail, and a carriage return keystroke. 
The command keyword identifies a command 
(program) to be executed. The optional 
command tail can consist of a file 
specification and some options or 
parameters. To complete the command you 
must press the carriage return key. 


CP/M FILE SPECIFICATIONS 


CP/M identifies every file by its unique 
file specification. A file specification 
can have three parts: a drive 
specification, a primary filename and a 
filetype, all separated by their 
appropriate delimiters. A drive letter 
must be followed by a colon. A filetype 
must be preceeded by a period. The term 
"filespec" is an abbreviation for file 
specification, and indicates any valid 
combination of the drive specification, 
the filename and the filetype. This 
summary uses the following symbols to 
designate the parts of a filespec. 


d: represents the optional drive 
specification, which can be a 
Single alphabetical character 
in the range A through P 
followed by a colon. 


filename represents the required primary 
filename, which can be 1 to 8 
alphabetic or numeric 
characters. 

typ represents the optional 


filetype, which can be 0 to 3 
alphabetic or numeric 
characters separated from the 
primary filename by a period. 


Valid combinations of the elements of a 
filespec are shown below: 


e filename 

e d: filename 

@e filename.typ 

e d:filename.typ 
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Certain CP/M commands can select and 
process several files when "wildcard" 
characters are included in the primary 
filename or filetype. The two wildcard 
characters are ?, which matches any single 
letter in the same position, and *, which 
matches any character at that position and 
any other characters remaining in the 
filename or filetype. The command ana ry 
indicates which commands can accep 
wildcard characters (* or ?) in a filename 
or filetype. 


COMMAND SUMMARY CONVENTIONS 


The command summary lists each CP/M 
command in alphabetical order using the 
following special symbols to define 


command syntax: 
Symbol Meaning 
{} indicate an optional item within 


DDT and ED. 
| separates choices. 


n indicates a number. 

<cr> indicates a carriage return 
keystroke. 

t indicates a "control" keystroke. 

re) indicates an option or option list. 


R/W means Read-Write. | 

R/O means Read-Only. 

SYS means System attribute. 

DIR means Directory attribute. 

pees preceeding element can be repeated 
as many times as desired. 


* wildcard- replaces all or part of 
a filename and/or filetype. 
? wildcard- replaces any single 


character in the same position. 


Note: the required parts of the command 
line are shown in boldface. Optional 


parts are in normal type. 
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ASM > 


Syntax: 


ASM filespec 
ASM filespec.ABC 


Purpose: 


ASM assembles assembly language 

Statements, producing an object file in 

hexadecimal format and a print file. The 

assumed source filetype is ASM. Character 

A indicates source file drive, B indicates 

HEX file destination, and C indicates PRN 

file destination. If you put a Z in 

position B or C the HEX file or PRN file 

is suppressed. An X in position C sends 
the print file to the console. 


Error Messages 


D- Data error: data statement element 
cannot be placed in specified data 
area 

- Expression error: expression cannot 

be evaluated during assembly 

- Label error: label cannot appear in 

this context (might be duplicate label) 

- Not implemented: unimplemented 

features, such as macros, are trapped 

Overflow: expression is too complex to 

evaluate 

- Phase error: label value changes on 

two passes through assembly. 

- Register error: the value specifie 
as a register is incompatible with 
the code . 3 ; 

S - Syntax Error: Improperly formed 

expression 
U - Undefined Label: Label used does 
not exist 

V - Value error: improperly formed 
operand encountered in an 
expression 


x» Wd O =  & 
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Examples: 


A>ASM PROG 
A>ASM b:PROG.ABX 
A>ASM b:PROG.bzz 
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Syntax: 


DDT filespec 


Purpose: 


DDT debugs 8080 programs. If you specify 
DDT without a filespec, DDT loads into the 
TPA and waits for a forthcoming file. The 
command character can be followed by one 
Or more arguments, which can be 
hexadecimal values, file specifications or 
other information, depending on. the 
command. Arguments are separated from 
each other by commas or spaces. No spaces 
are allowed between the command character 
and the first argument. Optional parts of 
the command are enclosed in curly brackets 


As (Assemble) 
Enter Assembly Language Statements 


p{s{,tf}} (Display) . 
Display Memory in Hex and ASCII 


Fs,f,bc (Fill) 
Fill Memory Block - Byte 


G{s}{,b1{,b2}} (Go) 
Begin Execution 


Hcl,c2 (Hex) 
Hexadecimal Sum and Difference 
Ifilespec (Input) 

Set Up Input Command Line 
L{s{,£}} (List) 


List Memory in Mnemonic Form 


Ms,f,d (Move) 
Move Memory Block 


R{o} (Read) 
Read Disk File to Memory 


Ss (Set) 
Set Memory Values 


t{n} (Trace) 
Trace Program Execution 


a a 


DDT (continued) 


u{n} 
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(Untrace) 


Monitor Execution without Trace 


x{r} 


(Examine) 


Examine and Modify CPU Registers 


sl 


Examples: 


A>DDT 


Meaning 


byte constant 
breakpoint one 
breakpoint two 

byte or word constant 
destination for data 
final address 

number of instructions 
to execute 

offset to load address 
8080 CPU register or 
flag name 

starting address 
second starting address 


A>DDT PROGRAM.COM 
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DIR 


Syntax: 
DIR d:filename.typ 


Purpose: 


DIR displays names of files on the 
specified disk. DIR does not show files 
set to SYS with the STAT command. 


Examples: 


A>DIR 
A>DIR B: 

A>DIR B:MYFILE. TEX 
A>DIR A*.ASM 

A>DIR PROG???.PRN 
A>DIR PROGRAM. * 
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ED 


Syntax: 
ED d: filename.typ 
Purpose: 
ED is the CP/M line editor. Using the ED 


subcommands, you can alter your file. 


Examples: 
A>ED TEST .DAT 


ED Control Characters 


TL Logical <cr><lf> within 
strings 
X Line delete 
Z String terminator/separator 
Rubout Delete character 
Break Stop function 
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Command Action 


nA 
append n lines from original file 
to memory buffer 


OA 
append file until buffer is half 
full 

#A 
append file until buffer is full 
(or end of file) 

B, -B 
move CP to the beginning (B) or 
bottom (-B) of buffer 

nc, -ncCc 
move CP n characters forward (C) or 
back (-C) through buffer 

nD, -nD 
delete n characters before (-D) or 
after (D) the CP 

E 


save new file and return to CP/M 


ce fies | | | CP/M Command Summary CP/M Command Summary 


ED Command Summary (continued) ED Command Summary (continued) 
| ' 
Fstring{1z} | Sdelete strfZinsert str{1z} 
find character string ee substitute string 
save the new file, then reedit, type n lines 
using the new file as the original 
file j U, -U 
upper-case translation 
i I i 
enter insert mode; use {Z to exit | Vv, -V, OV 
insert mode | line numbering on/off, display 
) - | free buffer space 
Istring{1z} : 
insert string at CP | nw 
| write n lines to new file 
Jsearch strfZinsert_strfZdelete_ to str{{z} 
uxtapose strings nx ; 
write n lines to temporary LIB file 
delete (kill) n lines from the CP delete file xS$$$$$$$.LIB 
nL, -nL, OL 
move CP n lines nz ' 
wait n seconds 
nMcommands 
execute commands n times 
Nn, -n 
move CP n lines and display that 
line 
ns 
move to line n 
sncommand 
| execute command through line n 
fi Nstring{{z} 
extended find string 
Oo 
return to original file 
nit nP, —nP 
Hes move CP 23 lines forward and 
te display 23 lines at console 
ait Q 
abandon new file, return to 
CP/M | 
R 
read X$$$$$$$.LIB file into buffer 
Rfilespec 
read filespec.LIB into buffer 
ii 8 ‘ 
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BRA : MOVCPM 


I Syntax: { Syntax: 

/ ERA d: filename.typ | MOVCPM *|nn|nn *|* * 

ey Purpose: Purpose: 

Vi : figures an nnkKbyte version of 

I ERA erases a file or group of files. ERA MOVCPM config : 

fi . ‘ : .. CP/M. If you specify a leading asterisk 

Hi RECORDED: WALRERES FASONARES (*) instead of nn, CP/M calculates the 

{) | proper memory size. If you add the * 

: Examples: switch following the numbers, CP/M leaves 

[i . the new version in memory for a SYSGEN or 

fee A>ERA PROGRAM.BAS SAVE operation. SYSGEN writes a copy of 

i A>ERA B:LETTER.DAT the relocated system on the system tracks 

A>ERA A: LETTER. * of the destination disk. SAVE creates a 
A>ERA * BAK file of the relocated system and writes it 
A>ERA B:*.* to the default or specified disk. If you 


do not specify the trailing * switch, 

MOVCPM moves the new version to the proper 

t location for the target memory size and 

i this new system executes. Note that in 
f . most cases the trailing * is required. 


Examples: 


A>MOVCPM 48 * 
A>MOVCPM * * 
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PIP PIP (continued) 


- Verify that data has been 

written correctly 

| WwW - Write over files that have 
been set to Read-Only 

- Zero the parity bit 


Syntax: 


PIP dest-file=src-file[(option],... 


PIP dest-file|dev=src-file[option] |dev[o] Examples: 


Purpose: 


COPY FROM ONE DISK TO ANOTHER: 


PIP copies files, combines files and 
transfers files between peripheral 
devices. The first filespec is the 
destination; the second filespec is the 
source. The source or destination can, be 
{| any CP/M logical device. PIP entered with 
iii no command tail displays a * prompt and 
His awaits your series of commands, entered 
and executed one line at a time. Source 
filespecs with options can be repeated, 
separated by commas, to combine two or 
more files into one file. 


A>PIP B: = A:DRAFT.TEX 
A>PIP B:DRAFT.TEX = A: 


COPY A FILE AND RENAME IT: 


A>PIP B:NEWDRAFT.TEX = A:OLDDRAFT. TEX 
A>PIP NEWDRAFT.TEX = OLDDRAFT .TEX 


COPY MULTIPLE FILES: 


A>PIP <cr> 

A>PIP B: = *.TEX [AV] 
A>B: = *.COM [RW] 
A>PIP B: = C:DRAFT.* 


Ee PIP Options 
: A>PIP B: = *,* 


i Option Description A>PIP B: = C:*.* 
| A ~ Archive: Copy only modified 
| files “ 
| Dn - Delete any characters past COMBINE MULTIPLE FILES: 
column n a ) 
g « Bano *¢ranesfer to console A>PIP B:NEW.DAT = .FILE].DAT,FILE2.DAT 
F - Filter form-feeds from source : 
data ‘ 
it! sn aks £RLe: Seow Var nueber xn COPY, RENAME AND GET FROM USER 1: 
Hi S Eeeet for yarse hee cOrMet A>PIP NEWDRAFT.TEX = OLDDRAFT .TEX[G1) 
{| i! I - Ignore :00 Hex data records, : 
| test for valid Hex format 
He L =~ Translate upper-case to lower- COPY TO/FROM LOGICAL DEVICES: 
SRGH case 
He N - Number output lines, starting A>PIP B:FUNFILE.SUE = CON: 
li at 1, by 1 3 | A>PIP LST: = CON: 
Hie fe) - Object file transfer, [Z A>PIP LST: = B:DRAFT.TEX [T8] 
Uh ignored é : DRAFT. 
l Pn - Set page length to n | Se ee ee o 
He (default n = 60) | 
ii QsfzZ - Quit copying from source at PIP Logical Devices 
Hi String s 
{i R - Read files that have been 
ate N 
pet to avs. (eystem oem cenein. nists 
| Ssfz - Start copying from the ot” Punch device 


source at the string s 
Tn ~- Expand tabs to n spaces 
U - Translate lower-case to 
upper-case 


RDR Reader device 
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ue 
L 
I PIP (continued) REN 
1 
le (These four devices are mapped in the 
k IOBYTE using STAT and must be defined in 
ie BIOS.) | Syntax: 
| INP Patched character input , , . 
| OUT Patched character output REN d: newfilespec.typ = oldfilespec.tyr 
fir PRN Like LST; tabs on 8th character, 
ke page breaks on 60th line, numbers 7 Purpose: 
fie lines | | 
fh EOF Generates control-2 (End-of-File) REN changes the name of the existing file 
He NUL Generates 40 nulls for PUN device \: called oldfilespec to the name specified 
H by newfilespec. You cannot specify files 
H PIP Physical Devices on two different drives. 
Hy TTY Console, terminal, reader, Ys ; 
punch, teletypewriter Examples: 
CRT Console, terminal, CRT device 
PTR Paper tape or card reader A>REN NEWFILE.DAT = OLDFILE.INP 
PTP Paper tape or card punch A>REN B:NEWFILE.DAT = OLDFILE.DAT 
LPT List device, line printer A>REN B:NEWLIST = OLDLIST 


UCl User-defined console 

UR1 User-defined reader 

UR2 User-defined reader 

UPl User-defined punch 

UP2 User-defined punch 

UL1 User-defined listing device 
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SAVE 


Syntax: 
SAVE n d: filename.typ 


Purpose: 


SAVE reads n 256-byte pages from the TPA 
and saves them on disk. Use DDT to 
determine the size of your program. 


Examples: 


A>SAVE 3 X.COM 
A>SAVE 40 Q 

A>SAVE 4 X.Y 
A>SAVE 10 B:ZOT.COM 
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STAT 


Syntax: 
Display Status: 


STAT d: 

STAT filespec 

STAT d:DSK: 

STAT DEV: | VAL: |USR: 


Change Status: 


STAT d:=R/0 
STAT filespec $R/0|R/W|SYS|DIR 
STAT filespec $S 


Purpose: 


STAT returns information about disk 
drives, files and other peripheral devices 
attached to the computer. STAT changes 
attributes of drives and files. STAT with 
no command tail returns free storage space 
in kilobytes for the current drive, and 
also tells if the drive is Read-Only (R/O) 
or Read-Write (R/W). Use STAT to set the 
drive to R/O and {fC to reset it to R/W. 
STAT filespec returns the number of 
kilobytes used by and the attributes of 
that file. STAT filespec can with an 
option set a file or files to R/O, R/W, 


SYS or DIR. Files set to SYS are. 


displayed in parentheses. STAT DSK: shows 
the characteristics of the default or 
specified drive. STAT USR: shows which 
user numbers contain files on a given 
diskette. STAT VAL: shows the possible 
commands and the external devices that can 
be assigned to your computer. STAT 
accepts wildcards in the command tail. 


STAT Options: 


R/W == Read-Write 

R/O = Read-Only 

sys = System attribute 

DIR = No system attribute 

S = Show the size of the file or 


files based on last record 
numbers 

VAL: = Shows possible STAT commmands 
and devices 

USR: = Shows USER numbers containing 
files 

DSK: = Shows characteristics of the 
drive 
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STAT (continued) SUBMIT — 
Examples: 
A> STAT Syntax: 


A>STAT B: = R/O 

A>STAT myfile.txt 
A>STAT C:letter.bak 
A>STAT genledgr.dat $R/O 
A>STAT *.com $R/O 


A>STAT *.bak 
A>STAT B:*.* 


SUBMIT filespec parameters 


Purpose: 


SUBMIT filespec starts execution of a file 

of CP/M commands (one command per line in 

the file). The SUBMIT file must have a- 
SUB filetype. Any optional parameters 

following the file specification in the 

. command line, such as a drive or file 

specification, are substituted for their 

corresponding formal parameters ($1,$2...) 

in the SUBMIT file. 


Examples: 


A>SUBMIT START 
A>SUBMIT B:START 
A>SUBMIT START C: LETTER 
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SYSGEN 


Syntax: 
SYSGEN d:filename.typ 


Purpose: 


SYSGEN copies CP/M operating system on the 
system tracks on the source disk to the 
destination disk. You can create one or 
more CP/M system disks in one SYSGEN 
session. SYSGEN with a file specification 
does not prompt for a source drive but 
uses the specified file as the source. 


Examples: 


To create a CP/M disk in drive B from a 
CP/M disk in drive A: 


A>SYSGEN 


SYSGEN VER 2.0 
SOURCE DRIVE NAME (OR RETURN TO SKIP)A 
SOURCE ON A, THEN TYPE RETURN<cr> 


FUNCTION COMPLETE 


DESTINATION DRIVE NAME Ae RETURN TO REBOOT)B 
DESTINATION ON B, THEN TYPE RETURN<cr> 


FUNCTION COMPLETE 


DESTINATION DRIVE NAME (OR RETURN TO REBOOT) <cr> 


To create a new CP/M disk using a single- 
drive system, put a fresh disk in A after 
the "DESTINATION DRIVE NAME" prompt line 
and type A. 


A>SYSGEN CPM32.COM 


DESTINATION DRIVE NAME (OR RETURN TO REBOOT) A 
DESTINATION ON A, THEN TYPE RETURN<cr> 
FUNCTION COMPLETE 
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TYPE 
Syntax: 
TYPE d: filename.typ 
Purpose: 
Displays contents of an ASCII file on the 
screen. Press any key to discontinue the 
display. TYPE does not accept wildcard 
filespecs. Entering a {P prior to the 
type command causes the output to be 
» echoed to the printer until another {7P is 
entered. 
Examples: 


A>TYPE letter.dat 
B>TYPE a:document.law 
B>TYPE program.bas 
A>TYPE reader.asm 
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USER 
Syntax: 

USER n 

n = 0-15 
Purpose: 


Displays and changes the current user 
number. USER with no command tail 
displays the current user number. USER 
with a number from 0 to 15 changes the 
Current user number to the number 
specified by n. CP/M assumes a default 
user number of 0. 


Examples: 
A>USER 


B>USER 2 
A>USER 7 
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XSUB 


Syntax: 
XSUB 


Purpose: 


XSUB lets programs using buffered input, 
such as ED, run in SUBMIT files. The XSUB 
command appears as the first statement in 
the SUBMIT file. 


Examples: 
A>TYPE SAVER.SUB 


XSUB 

DDT 

I$1.HEX 

R 

GO 

SAVE 1 $2.COM 
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CP/M CONTROL CHARACTER SUMMARY 


Keystroke Action 


BACKSPACE moves cursor back one space; 
erases previous character. 


tc prompts to abort a program 
currently running at a given 
console. 

DEL Same as RUB. 


forces a physical carriage 
return, but does not send 
command to CP/M. 


Same as BACKSPACE. 


line-feed, terminates input at 
the console. 


Same as carriage return. 


echoes all console activity at 
the printer; a second ‘P ends 
printer echo. This only works 
if your system is connected to 
a printer. 


TR retypes current command line; 
useful after using RUB or DEL 
key. 


RETURN carriage return. 


RUB deletes character to the left of 
cursor; echoes character 
deleted - cursor moves right. 


stops console listing 
temporarily; 7S resumes the 
listing. 


cancels line, displays #, cursor 
moves down one line and awaits 
a new command. 


deletes all characters in 
command line. 


string or field separator. 
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CP/M FILETYPES 


CP/M identifies every file by a unique 
file specification, hich consists of a 


drive specification, a filename, and a 
filetype. The filetype is an optional 
three character ending separated from the 
filename by a period. The filetype 
generally indicates a special kind of 
file. The following lists common 
filetypes and their meanings. 


Type Indication 


~ ASM Assembly language source file; 


the CP/M Assembler, ASM, 
assembles or translates a type 
-ASM file into machine language. 


BAK Back-up file created by text 
editor; the editor renames the 
source file with this filetype 
to indicate that the original 
file has been processed. The 
Original file stays on disk as 
the backup file, so you can 
refer to it. 


BAS cBasic ® program source file. 

COM 8080 executable file. 

HEX Program file in hexadecimal 
format. 

INT CBASIC program intermediate 
language file. 

IRL Indexed REL file produced by LIB. 

LIB Used by mAC’™™ and RMAC™ for 


macro libraries. The ED R 
command reads files of type LIB. 
The ED X command writes files of 
type LIB. Printable file 
Gdisplayable on console or 
printer. 


OVL Program overlay file. PL/1-80'™: 
compiler overlays files; you can 


create overlay files with LINK- 
so". 


PL/I-80 source program filetype. 
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CP/M Filetypes (continued) 


PRL Page Relocatable file; a file 
that does not require an-. 
absolute segment. It can be 


relocated in any Page Boundary 
(256. Bytes). 


= 
3 


aie 


SRT PS ee me 
se gaa: Baan TUR Bn an Ame Ha dF 


PRN Printable file displayable on 
console or printer. 


ae 


REL Relocatable file produced by RMAC 
and PL/I-80 which can be linked 


by LINK-80. 


SUB Filetype required for submit file 
containing one or more CP/M 
commands. The SUBMIT program 
executes commands in files of 
type SUB, providing a batch 
execution mode for CP/M. 


SYM Symbol table file. MAC, RMAC and 
LINK-80 output files of type 
SYM. SID'™ and zSID™:> read 
files of type SYM. 


Pet abimieemal LOR Saepe AWA Wade ae ty hs nah rem cman ah a Kam tetris el no 08 nape: ake et mtn tae 


TEX Source file for, TEX-80'™', the 
| . Digital Research text formatter. 


A A Aa fen Wh 


ea 


| XRF Cross-Reference file produced by 
b 3 XREF . 


Temporary file. 


